home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_6 / tread2_2.lha / DLGUPLOA.DOC < prev    next >
Text File  |  1994-08-25  |  7KB  |  170 lines
  1.    ****   **      ****  **  **        **                    **
  2.    ** **  **     **  ** **  **        **                    **
  3.    **  ** **     **     **  ** *****  **   ****   ****   *****
  4.    **  ** **     ** *** **  ** **  ** **  **  **     ** **  ** v 0.57
  5.    **  ** **     **  ** **  ** **  ** **  **  **  ***** **  **
  6.    ** **  **     **  ** **  ** *****  **  **  ** **  ** **  ** by Michael
  7.    ****   ******  *****  ****  **      **  ****   *****  *****     Dreher
  8.                                **
  9. What is it ??
  10. ~~~~~~~~~~~~~
  11. Just a simple proggie that enables you to Upload Files from a script
  12. or from the DOS-Shell to any File-Area or User's directory.
  13.  
  14.  
  15. Why DLGUpload ??
  16. ~~~~~~~~~~~~~~~~
  17. You know these problems ??:
  18.  
  19. - when online from remote, you get a message from a user who asks
  20.   for a special file which is not in the file-areas... You know that
  21.   it's on the system's harddisk, but it takes to much time to bring it
  22.   to that user's directory or a file-area. (there might be several
  23.   changes necessary between the DOS-Shell and FileMaint.. too much
  24.   work...)
  25. - you are at home and a user asks for a file or you have finished
  26.   the new KeyFile for XY, but you don't want to log in just for
  27.   uploading a file...
  28. - you have automated scripts which generate files to be uploaded to
  29.   several file-areas, but you have to upload them manually...
  30. - maybe you know some more examples, I think it's enough :-)
  31.  
  32. Here is the solution for these problems, an easy-to-use, fast and
  33. powerful CLI-type proggie that allows you to upload files to users
  34. and file-areas with full support of DLG's very own data-files and
  35. structures...
  36.  
  37. (You might also want to try Calibre System's Upload2-program, which
  38.  also has been adapted to the new structures of DLG... compare them
  39.  and use the one you like better, I know that the old version of
  40.  DLGUpload was (is ?) used on MANY systems around the DLG-world :-)
  41.  
  42.  
  43. DLGUpload (v 0.57), what does it ??
  44. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45. - allows to specify a Description (upto 99 chars)
  46. - allows to specify a Textfile to take the Description from
  47. - allows to specify an Uploader
  48. - allows to make the file [FREE]
  49. - no need of "C:Copy" or other stuff and even SHORTER
  50.   than similar proggies... (currently less than 9k, 100% machine-code)
  51. - no GURU when Dest-Dir not exists
  52. - only ONE *.fd file for each upload
  53. - seems to be quite safe and requires a minimum of 40 k of memory
  54. - uses alternate storage paths from File:area.bbs
  55. - uses file:[area]/file.dat
  56. - uses User:First_Last/event.log on private Uploads
  57.  
  58. (When information on DLG.library will be available, DLGUpload might
  59.  also use system-messages or alter the upload-counters in the
  60.  Uploader's user.data-file :-)
  61.  
  62. How does it work ??
  63. ~~~~~~~~~~~~~~~~~~~
  64. When called, it will copy the specified file to the destination
  65. directory, look for a pointers.file, write a .fd-file, update the
  66. pointers.file and the file.dat. If no pointers.file or file.dat
  67. is found, one will be generated (only thing it does not is create
  68. File:Area.bbs if not existant :-)
  69.  
  70. The command-line for DLGUpload is:
  71.  
  72. DLGUpload <filename> <dest-path> <description> <uploader> [FREE]
  73.  
  74. where <filename>     is the path to the file which is to be uploaded
  75.       <dest-path>    is the path where the file and file-description
  76.                      shall be put (e.g. File:15/ or User:Michael_Dreher/)
  77.       <description>  is a short description that will be placed in
  78.                      the header-file (upto 100 chars at the moment)
  79.                      if you want to specify a filename use '^' as the
  80.                      first char ('^s:Descriptionfile' for example)
  81.       <uploader>     is the name which will be shown as uploader in
  82.                      the header-file
  83.          FREE        is a flag telling DLGUpload that this file has
  84.                      the FREE-attribute
  85.  
  86. If <dest-path> is "" the file will be uploaded to the current
  87. directory. If you want to leave a parameter out and use one of the
  88. following, you should replace it with "" (will not work for
  89. <filename> :-)
  90.  
  91. No need of "/" at the end of the path, will be added automagically..
  92.  
  93. The minimum is:
  94.  
  95. DLGUpload <filename>
  96.  
  97. all other parameters will get defaults then...
  98.  
  99. Examples:
  100. ~~~~~~~~~
  101. DLGUpload s:startup-sequence user:marcus_kuba "Just a test" "Michael Dreher"
  102.  
  103. - will upload the Startup-sequence to Marcus Kuba's private
  104. file-area with a description of "Just a test" and Michael Dreher as
  105. uploader.
  106.  
  107. DLGUpload Batch-Upload:FF460.lzh File:31 "^Contents460" "SysOp" FREE
  108.  
  109. - will upload the File FF460.lzh to File-Area 31 with the FREE-Flag
  110. set and uses the file "Contents460" as description. The Uploader is "SysOp"
  111.  
  112. cd File:89
  113. DLGUpload S:PC-Startup
  114. DLGUpload Testfile
  115.  
  116. - will upload the files 'S:PC-Startup' and 'Testfile' in file area 89
  117.   and uses default uploader and default description
  118.  
  119.  
  120. How must I install it ??
  121. ~~~~~~~~~~~~~~~~~~~~~~~~
  122. Oh, this is the simplest.., just copy DlgUpload anywhere in your path,
  123. we have it in C: right now. For easier use rename it to "Upload", this
  124. will ensure that you don┤t need to change any of your scripts which
  125. use Upload right now (but you should do so to make use of DLGUploads
  126. additional features :-)
  127.  
  128.  
  129. CopyRight:
  130. ~~~~~~~~~~
  131. DLGUpload is Freeware, which means that you can spread it to anyone
  132. you like, as long as all files are intact and the original archive
  133. is NOT altered (this means also that you may NOT add any files
  134. or change the ZZZIBASE.foo textfile included in this archive !!).
  135. If you like and use DlgUpload, it would by nice, if you send us
  136. YOUR Freeware/Shareware proggies, even a message would be nice...
  137.  
  138.  
  139. author:
  140.  
  141.             Michael Dreher
  142.             Wielandstr. 12
  143.             7250 Leonberg
  144.             West Germany
  145.  
  146. Fido Netmail:  2:247/706  Intuition Base ++49-7152-45768
  147. UUCP email:    Michael_Dreher@ibase.stgt.sub.org
  148.  
  149. or write to:
  150.  
  151. Marcus Kuba, SysOp of 2:247/706 / ibase.stgt.sub.org
  152. (Intuition-Base, DLGTopX, DLGUpload and CONTRIS!-Support-BBS :-)
  153.  
  154. Special thanks:
  155. ~~~~~~~~~~~~~~~
  156. Marcus Kuba      : - He had the ideas for the additional features
  157.                    - He wrote this documentation.
  158.  
  159. Tom Conroy (TPT) : - for DLG Pro and testing DLGUpload
  160.  
  161. Patrick Young    : - for A68k 2.71 (which was used to make DLGUpload)
  162.  
  163. Disclaimer:
  164. ~~~~~~~~~~~
  165.  
  166. We are in no way responsible for anything this program does; you are using it
  167. entirely at your own risk ! (This means that if DLGUpload formats your
  168. harddisk, it's your personal problem :-), but you can believe me: it
  169. has been tested long enough to be safe...)
  170.